docs: don't use <guimenuitem>

We don't want to assume menu bar structures.

diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 98057225c9128e4e2599b8e7191073f1a7bbb6a2..ad2dbe443373135dec8166aacd168e59e5d1b155 100644 (file)
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -735,10 +735,10 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser)
  * Note that the file must exist, or nothing will be done except
  * for the directory change.
  *
- * You should use this function only when implementing a <guimenuitem>File/Save
- * As...</guimenuitem> dialog for which you already have a file name to which
+ * You should use this function only when implementing a save
+ * dialog for which you already have a file name to which
  * the user may save.  For example, when the user opens an existing file and
- * then does <guimenuitem>File/Save As...</guimenuitem> on it to save a copy or
+ * then does Save As... to save a copy or
  * a modified version.  If you don't have a file name already &mdash; for
  * example, if the user just created a new file and is saving it for the first
  * time, do not call this function.  Instead, use something similar to this:
@@ -1087,10 +1087,10 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser)
  * Note that the URI must exist, or nothing will be done except for the 
  * directory change.
  *
- * You should use this function only when implementing a <guimenuitem>File/Save
- * As...</guimenuitem> dialog for which you already have a file name to which
- * the user may save.  For example, whenthe user opens an existing file and then
- * does <guimenuitem>File/Save As...</guimenuitem> on it to save a copy or a
+ * You should use this function only when implementing a save
+ * dialog for which you already have a file name to which
+ * the user may save.  For example, when the user opens an existing file and then
+ * does Save As... to save a copy or a
  * modified version.  If you don't have a file name already &mdash; for example,
  * if the user just created a new file and is saving it for the first time, do
  * not call this function.  Instead, use something similar to this:
@@ -1453,10 +1453,10 @@ gtk_file_chooser_get_files (GtkFileChooser *chooser)
  * Note that the file must exist, or nothing will be done except
  * for the directory change.
  *
- * If you are implementing a <guimenuitem>File/Save As...</guimenuitem> dialog,
+ * If you are implementing a save dialog,
  * you should use this function if you already have a file name to which the
  * user may save; for example, when the user opens an existing file and then
- * does <guimenuitem>File/Save As...</guimenuitem> on it.  If you don't have
+ * does Save As...  If you don't have
  * a file name already &mdash; for example, if the user just created a new
  * file and is saving it for the first time, do not call this function.
  * Instead, use something similar to this:

diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index c7d2410dec03ac238896ab000f6a631fe7070853..74e9c433a31e6ad71419f36ab57c534ffb88f255 100644 (file)
--- a/gtk/gtkfilechooserdialog.c
+++ b/gtk/gtkfilechooserdialog.c
@@ -113,17 +113,14 @@
  * <section id="gtkfilechooserdialog-setting-up">
  * <title>Setting up a file chooser dialog</title>
  * There are various cases in which you may need to use a #GtkFileChooserDialog:
- * <itemizedlist><listitem>To select a file for opening, as for a
- *   <guimenuitem>File/Open</guimenuitem> command.  Use
+ * <itemizedlist><listitem>To select a file for opening. Use
  *   #GTK_FILE_CHOOSER_ACTION_OPEN.
  * </listitem>
- * <listitem>To save a file for the first time, as for a
- *   <guimenuitem>File/Save</guimenuitem> command.  Use
+ * <listitem>To save a file for the first time. Use
  *   #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as
  *   "Untitled" with gtk_file_chooser_set_current_name().
  * </listitem>
- * <listitem>To save a file under a different name, as for a
- *   <guimenuitem>File/Save As</guimenuitem> command.  Use
+ * <listitem>To save a file under a different name. Use
  *   #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename
  *   with gtk_file_chooser_set_filename().
  * </listitem>
@@ -140,8 +137,7 @@
  * able to make good suggestions on its own.  In general, you
  * should only cause the file chooser to show a specific folder
  * when it is appropriate to use gtk_file_chooser_set_filename(),
- * i.e. when you are doing a <guimenuitem>File/Save
- * As</guimenuitem> command and you already
+ * i.e. when you are doing a Save As command and you already
  * have a file saved somewhere.
  * </para>
  * </note>